home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d932.lha / DynamicSkies / Docs / Manual.doc < prev    next >
Text File  |  1993-12-20  |  19KB  |  393 lines
  1. 'Dynamic Skies'                 Manual.doc
  2.  
  3.  
  4.     What do you need a manual for ? Isn't this program intuitive ? What, No ?
  5. All right, let's have a complete description of the menus and functions. It's
  6. only because you insisted.
  7.  
  8.  
  9.  
  10. MENUS
  11. -----
  12.  
  13.     There are seven menus : Project, Modules, Time, Numerical, Visual,
  14. Libraries and Animations. Visual and Animations are activated only in LOCAL
  15. SKY or PLANETARIUM modes. Other menus may be deactivated, depending on the
  16. modes and the version ( Public Domain or Registered ).
  17.  
  18. PROJECT menu ----------------------------------------------------------------
  19.  
  20.     Local Time:         Brings a request to set local time and date in our
  21.                         good old Gregorian calendar ( whatever the validity
  22.                         of this calendar, nothing forbids you to go to year
  23.                         99999 or -99999 if you want ). U.T. ( Universal Time
  24.                         is set accordingly, depending on your position, a
  25.                         summer hour and politic time shifts ( Position menu
  26.                         sets this ).
  27.  
  28.     Universal Time :    Local Time's mate. Sorry for the clumsy old string
  29.                         gadgets ; Version 1.1 will handle this better, with
  30.                         nice little buttons everywhere. Universal Time is
  31.                         the reference time based on the Greenwich meridian.
  32.  
  33.     Position :          Here you set your coordinates in longitude, latitude,
  34.                         height and politic time shift. This last is expressed
  35.                         in hours, the shift from the meridian local time. It
  36.                         is often 0 hours, but sometimes countries adopt 1 more
  37.                         or less hour just to please them in their difference.
  38.                         Well, sorry, you'll probably have to throw yourself in
  39.                         an atlas for now.A later version of Dynamic Skies will
  40.                         let you choose your position on the globe or from a
  41.                         list. Latitude is between -90 and 90° while longitude
  42.                         is between -180° (East) and +180° (West). Your set
  43.                         may be saved ( file 'Position.txt' in the 'Configs'
  44.                         drawer ). It is a text format which can be altered
  45.                         from a text editor if you wish.
  46.  
  47.     Save configuration: As there are so many numerical and visual options,this
  48.                         enables you to save your favorite options set. Next
  49.                         time Dynamic Skies is loaded, you won't be sorry.
  50.                         The file is 'Config.data' in the 'Configs' drawer. If
  51.                         you delete it, a default set is loaded.
  52.  
  53.     Interlaced screen : ON/OFF switch to double the vertical resolution. This
  54.                         option is only activated for map modes.
  55.  
  56.     NTSC/PAL :          This switch reorders screen and windows to make them
  57.                         squeeze totally in the chosen mode. This option of
  58.                         course doesn't affect the monitor scan rate.
  59.  
  60.     Languages :         Brings a request that lets you choose your language
  61.                         for all texts printed on the screen. Menus are also
  62.                         handled. The program may pause a few seconds in order
  63.                         to recompute every text.
  64.  
  65.     About :             Just for not being forgotten...
  66.  
  67.     Quit :              Back to AmigaDos or WorkBench world.
  68.  
  69. MODULES menu -----------------------------------------------------------------
  70.  
  71.     Numerical Ephemeris: All kind of information on celestial objects.
  72.  
  73.     Planetarium :       Celestial sphere maps in equatorial system.
  74.  
  75.     Local Sky :         Same thing in local system.
  76.  
  77.     Events :            Celestial events predictor.
  78.  
  79. TIME menu --------------------------------------------------------------------
  80.  
  81.     Advance :           Advance time with current value of T.
  82.  
  83.     Go Back :           Go back in time with current value of T.
  84.  
  85.     Update :            Load the system time.
  86.  
  87.     T= XXXX:            Brings a request that lets you fix the numerical
  88.                         value of a time variation.
  89.  
  90.     Units :             Sub-menus precise the time variation unit.
  91.                         ( Centuries, hours, days, ... )
  92.  
  93.     Follow target :     This switch affects target positionning while maps
  94.                         are recomputed due to time variations.
  95.                         When active, maps stay centered on pointed object or
  96.                         sky direction. Otherwise, coordinates are conserved.
  97.  
  98. NUMERICAL menu --------------------------------------------------------------
  99.  
  100.     Precession :        Switch for equinox precession correction.
  101.  
  102.     Nutation :          Switch for nutation correction.
  103.  
  104.     Abberation :        Switch for annual abberation correction.
  105.  
  106.     Apparent positions: Switch for planetary position correction due to the
  107.                         light's speed limitation.
  108.  
  109.     Parallaxe :         Switch for parallaxe correction ( stars and planets )
  110.  
  111.     Refraction/Depression :
  112.                         Switch for terrestrial atmosphere refraction and
  113.                         surface height corrections.
  114.  
  115.     Proper movement :   Switch for proper movement correction for the stars.
  116.                         Current star library must contain proper movement
  117.                         data if you want to observe this correction.
  118.                         ( mu(alpha) and mu(delta) data ).
  119.  
  120.     Goto decimal/  :    Angular data will be displayed with classical decimal
  121.       sexagedecimal     system or with standard arcminutes and arcsecondes.
  122.  
  123.     Decimals :          Sub-menus let you choose the number of decimals after
  124.                         the floating point. ( for displaying purpose )
  125.  
  126.     Planetary theory :  Choose between precise planetary theory ( VSOP 87 with
  127.                         1'' precision ) or a fast simplified planetary
  128.                         theory. The latter is the only one available for
  129.                         Public Domain users.
  130.  
  131.     Hour mode :         This switch affects right ascension format for the
  132.                         display, that is between the hour format ( popular
  133.                         use ) or the common angular format ( for legal
  134.                         systems maniacs ).
  135.  
  136. VISUAL Menu ------------------------------------------------------------------
  137.  
  138.     Deep Sky :          Switch for deep sky objects plotting.
  139.  
  140.     Planets :           Switch for planets plotting. The program may pause
  141.                         to recompute planets positions if there is need.
  142.                         ( as after a time change )
  143.  
  144.     Target :            Switch for the display of a centered little cross.
  145.  
  146.     Measure mode :      In this mode, left mouse button clicking drops an
  147.                         anchor point. While maintaining the button down,
  148.                         move to the desired position and release pressure to
  149.                         drop the second anchor point. The program will then
  150.                         compute and display the angular distance separating
  151.                         the two points. If you're not in this mode, left
  152.                         mouse button clicking centers the map at the mouse
  153.                         position; moving the mouse before releasing the
  154.                         button lets you zoom in exactly at desired field.
  155.  
  156.     Full Screen mode :  In this mode, PLANETARIUM and LOCAL SKY maps are
  157.                         filling the entire display, discarding all
  158.                         command buttons.
  159.  
  160.     Units :             Define the step unit ( degree, arcminute, arcsecond )
  161.                         for the movement on the maps with the arrows.
  162.  
  163.     Definitions :       Sub-menus will direct you for setting steps or options
  164.                         with many add-ons figures and names available for maps
  165.  
  166.     Figures :           Sub-menus will let you choose for an immediate
  167.                         drawing of the ecliptic, the horizon, constellations
  168.                         patterns and limits or the exact field of view.
  169.  
  170.     Names :             Switchs add or retrieve names for stars, objects,
  171.                         planets and constellations, according to formats set
  172.                         in the 'Definitions' menu.
  173.  
  174.     Magnitude Thresholds :
  175.                         Set low and high thresholds for magnitude of stars
  176.                         and objects.
  177.  
  178.     Star aspect :       Choose between three display formats for stars :
  179.                         real, spectral or map.
  180.  
  181.     Inversion ;         You may invert the maps horizontally or vertically
  182.                         for telescope simulation purposes.
  183.  
  184.     Oops! :             Go back to last map position.
  185.  
  186. LIBRARIES Menu ---------------------------------------------------------------
  187.  
  188.     Stars :             Choose a new library of stars from the 'Starlibs'
  189.                         drawer.
  190.  
  191.     Objects :           Choose a new library of deep-sky objects from the
  192.                         'Objectlibs' drawer.
  193.  
  194. ANIMATION Menu ---------------------------------------------------------------
  195.  
  196.     Load :              Load a saved animation in memory. ( 'Anims' drawer )
  197.  
  198.     Save :              Save current animation from memory.
  199.  
  200.     Parameters :        Set animations parameters and compute an animation.
  201.  
  202.     Control :           Alter the way of animation playing.
  203.  
  204.  
  205. Some details about animations :
  206.  
  207.     For memory sake, animations are stored in form of points coordinates. You
  208.     may replay animations with any star aspect this way. Anyway, the screen
  209.     format for replay must reproduce the screen format under which the
  210.     animation was computed ( NTSC/PAL, Interlace, full screen ). The program
  211.     will warn and alter the format if incompatibility arises.
  212.     To replay animations, many options are possible :
  213.  
  214.     - Speed setting
  215.     - Start and end frames.
  216.     - Perpetual cycle
  217.     - Remanence ( no screen clearing after each frame ).
  218.     - Frame stop.
  219.  
  220.     At any moment, animation may be stopped with a left mouse button clicking
  221.     ( hold long sometimes ). Right mouse button clicking advances frames if
  222.     frame stop option is active.
  223.  
  224.     For time step animations, all time parameters are defined in the TIME
  225.     menu ; that is the delta ( T ) and the follow target option.
  226.  
  227.     For movement animation, time is hold but a camera sweeps across the sky
  228.     in programmable sequences. For each sequence, you may define coordinates
  229.     and zoom variations for spectacular effects. Any sequence can be repeated
  230.     the number of frames you want. ( Ex : RA=RA+1°, D=D, Z=Z ( 3 times ) is a
  231.     sequence which computes 3 frames with increase of the RA coordinate
  232.     ( horizontally ) by 1° every step )
  233.  
  234.     Lastly, for both of the animations types, 'Total images' sets the total
  235.     number of frames not to outgrow.
  236.  
  237.     Please note that deep-sky objects are not recorded in animations.
  238.  
  239. Some details about 'Dynamic Skies' handling :
  240.  
  241. Attention : For PLANETARIUM and LOCAL SKY modules, left mouse button clicking
  242.             in maps centers maps at mouse pointer location. If you keep the
  243.             mouse button down, moving the mouse makes a virtual size box
  244.             that let you zoom in the map. Right mouse button clicking brings
  245.             immediate information on pointed object. Because of this last
  246.             option, menus may appear only when you bring your mouse pointer
  247.             above or below maps. In full screen mode, bring the pointer to
  248.             the menu bar before clicking the right button.
  249.  
  250.     -If star aspect looks uniform or 'faded' on the screen, magnitude
  251.      thresholds may be ill set. The best set ( with the more colors and
  252.      shapes ) is achieved by a low threshold of -1.6 ( Sirius magnitude )
  253.      and a high threshold corresponding to the lowest magnitude of your
  254.      star library. Sometimes, too, 'Map' star aspect has more diversity.
  255.  
  256.     -Whenever you switch an option or module, the 'target' object stays
  257.      active.
  258.  
  259.     -Time is based on the julian millenium computed from the gregorian
  260.      calendar ( you know, the one everybody uses ). Leap years are taken
  261.      in account ( 1 day on February every 4 years, except years ending
  262.      in hundreds and not in 4 hundreds )., and the 10 days update in
  263.      october 1582 also ( try an ephemeris calendar at 1582 october ! ).
  264.      For this first version of 'Dynamic Skies', you have the disagreement
  265.      to enter manually the dates, with a DD.MM.YYYY format ( European style,
  266.      you note ). The year doesn't need to be in 5 digits ( Ex of legal
  267.      formats : 24.05.1993, 12.08.100, 21.01.-1200 ). Time is set in the
  268.      classical HH:MM:SS format.
  269.  
  270.     -One important point with the difference between local time and U.T.
  271.      ( Universal Time ) : the shift in hours is automatically computed
  272.      from the REAL time zone ( that is, 1 hour every 15° of longitude from
  273.      Greenwich time zone ). But, due to political or boundaries reasons, your
  274.      local time may differ from the one generated by this simple calcul.
  275.      You may for this reason add or substract hours in the Position setting,
  276.      at the command 'Meridian Shift'. You can only enter an integer here.
  277.      Ex : France, although in the same real time zone as Greenwich (England),
  278.      has one more hour in local time, the difference computed being 0 hours.
  279.      Adjustement is then made by entering (+)1 at Meridian Shift command.
  280.      True local time is now U.T. + 1 and not U.T. + 0.
  281.  
  282.     -Here are the accepted formats for star or object searching :
  283.      Stars :
  284.         -Usual name ( as Sirius, Capella, Rigel, ... )
  285.          It may be incomplete ( Sir for Sirius, Alph for Alpheratz, ... )
  286.         -HD XXXX : this is a popular catalog reference.
  287.         -SAO XXXX : this is another popular catalog reference.
  288.         -Alpha Great Bear ( or Alpha Ursa Major ), Zeta orion ,...
  289.         -21 Andromeda , 45 leo minor, ... ( Flamsteed number )
  290.      Objects :
  291.         -Usual name ( like Crab Nebula ). May be incomplete.
  292.         -NGC XXXX : New General Catalog.
  293.         -M XXXX : Messier catalog.
  294.      If the program doesn't understand you, try another name or designation.
  295.      But you can also search any object or star with formatted listings.
  296.      ( 'Constellation' option ). They are classified by constellations with
  297.      any format your desire ( HD, SAO, NGC, M, names ). If certain stars or
  298.      objects lack identification ( it may happen ), RA coordinate is only
  299.      given.
  300.  
  301.     -If you want to observe LUNAR eclipses, you probably know that this event
  302.      has one new guest : Earth's shadow. Dynamic Skies materializes this
  303.      object ( named 'Earth's shadow' ) while eclipses are in progress. This
  304.      shadow only includes the umbra, not the penumbra ( you can't really see
  305.      the latter after all, so it isn't important ).
  306.  
  307.     -If you have a PAL screen and the normal Dynamic Skies screen mode ( not
  308.      the full screen mode ), Local Time, Universal Time and Position settings
  309.      may be run just by clicking on their corresponding display surfaces.
  310.  
  311.      In normal screen mode with PLANETARIUM and LOCAL SKY modules, 3 boxes of
  312.      command fill the right of the screen :
  313.  
  314.      - The first one, titled 'Direction', contains 4 directional arrows and a
  315.        center button. If you click one of these arrows, the map shifts of X
  316.        units. X value is one of the 2 boxes right to these arrows, + or -,
  317.        that may be set. If the center button is '+', the unit is the value of
  318.        the '+' box. Same thing for the '-' set. So with just one click on the
  319.        center button, you can switch from large steps to small steps for
  320.        example. The moving unit ( degree, arcminute, arcsecond )  may be
  321.        changed in the 'units' command of the 'visual' menu.
  322.        In the small box below the arrows are displayed the coordinates of the
  323.        center of the map. Clicking in this region brings a requester which
  324.        lets you set exact coordinates and features preset coordinates like
  325.        S, N, W, Zenith, ...
  326.  
  327.     -  Second box, titled 'Field-Zoom', contains 2 buttons '+' and '-' for
  328.        zooming purposes. The multiplying factor is set with the 'x' gadget
  329.        at the right of these buttons. Just below are displayed the current
  330.        values of zoom and field, which are linked together. You may alter one
  331.        of these, but the important one is the field ( of view ). Zoom is in
  332.        fact an indication linked with the apparent field of the current
  333.        optical instrument ( Eyes, Binoculars or Telescope ). The latter can
  334.        be set by the menu ( Visual ) or by the binoculars shaped button just
  335.        here .Left to this button is an 'Oops' button which brings the map at
  336.        last location.
  337.  
  338.     -  The third box, titled 'Extras', contains tiny buttons switching many
  339.        visual options already existant in the 'Visual' menu.
  340.        The first set of six buttons is :
  341.             -Stars     : pass to a new star aspect.
  342.             -Objects   : switch for deep-sky objects.
  343.             -Planets   : switch for planets.
  344.             -Invert map horizontally.
  345.             -Invert map vertically.
  346.             -Target    : switch for target cross.
  347.        The next set includes :
  348.             -Grid      : draws a user formatted grid in RA and D coordinates.
  349.             -Ecliptic  : draws the ecliptic in blue.
  350.             -Horizon   : draws the horizon in yellow.
  351.             -Constellation limits  ( red )
  352.             -Constellation patterns  ( yellow )
  353.             -True field of view : draws the exact disc of the field because
  354.              maps are not square and always have more view laterally.
  355.  
  356.       If you set the full screen mode, the boxes of commands disappear. Use
  357.       then menus and keys :
  358.  
  359.             +,- keypad : Zoom
  360.  
  361.             ESC : Switch to Normal/Full screen.
  362.  
  363.             Arrows : move the map.
  364.  
  365.             0-9 Keypad :
  366.                 0 Sun
  367.                 1 Mercury
  368.                 2 Venus
  369.                 3 Mars
  370.                 4 Jupiter
  371.                 5 Saturn
  372.                 6 Uranus
  373.                 7 Neptune
  374.                 8 Pluto
  375.                 9 Moon
  376.  
  377.             C : Constellation
  378.             S : Star
  379.             O : Object
  380.  
  381.             G : Grid
  382.             H : Horizon
  383.             I : Ecliptic
  384.             P : Constellations Patterns
  385.             L : Constellations Limits
  386.             F : True Field of view
  387.  
  388.             Space Bar : Play animation
  389.  
  390.             TAB : Coordinates request
  391.  
  392.             DEL : Oops!
  393.